package com.ruoyi.order.mapper;

import java.util.List;
import com.ruoyi.order.domain.Order;
import org.apache.ibatis.annotations.Param;

/**
 * 订单信息Mapper接口
 * 
 * @author ruoyi
 * @date 2025-06-03
 */
public interface OrderMapper 
{
    /**
     * 查询订单信息
     * 
     * @param orderId 订单信息主键
     * @return 订单信息
     */
    public Order selectOrderByOrderId(Long orderId);

    /**
     * 查询订单信息列表
     * 
     * @param order 订单信息
     * @return 订单信息集合
     */
    public List<Order> selectOrderList(Order order);

    /**
     * 新增订单信息
     * 
     * @param order 订单信息
     * @return 结果
     */
    public int insertOrder(Order order);

    /**
     * 修改订单信息
     * 
     * @param order 订单信息
     * @return 结果
     */
    public int updateOrder(Order order);

    /**
     * 删除订单信息
     * 
     * @param orderId 订单信息主键
     * @return 结果
     */
    public int deleteOrderByOrderId(Long orderId);

    /**
     * 批量删除订单信息
     * 
     * @param orderIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteOrderByOrderIds(Long[] orderIds);

    /**
     * 根据顾客id和商品订单状态获取交易订单列表
     * @param orderQuery
     * @return
     */
    List<Order> selectOrderByGuestIdAndOrderStatus(Order orderQuery);


    /**
     * 根据顾客id和商品订单状态获取交易订单列表（分页）
     * @param guestId 顾客ID
     * @param masterStatus 订单状态
     * @param offset 偏移量
     * @param limit 限制数量
     * @return
     */
    List<Order> selectOrderByGuestIdAndOrderStatusWithPagination(@Param("guestId") Long guestId,
                                                                 @Param("masterStatus") String masterStatus,
                                                                 @Param("offset") int offset,
                                                                 @Param("limit") int limit);

    /**
     * 统计顾客id和商品订单状态下的订单数量
     * @param guestId 顾客ID
     * @param masterStatus 订单状态
     * @return
     */
    int countOrderByGuestIdAndOrderStatus(@Param("guestId") Long guestId,
                                          @Param("masterStatus") String masterStatus);


    /**
     * 获取订单列表时，将订单状态为'3'（退款中）的优先级设为最高，排在最前面
     * 获取交易订单汇总列表
     */
    List<Order> selectoOrderSummaryList(Order order);

    /**
     * 根据订单号查询订单信息
     *
     * @param orderCode 订单号
     * @return 订单信息
     */
    Order selectOrderByOrderCode(String orderCode);

    /**
     * 根据核销码查询订单
     *
     * @param verificationCode 核销码
     * @return 订单信息
     */
    public Order selectOrderByVerificationCode(String verificationCode);

}
